Group Navigation Bar Tool – Methods

The following table lists and describes methods of the Group Navigation Bar Tool. Methods are accessed using the control's script editor. See CxGrpNavBar Methods for more information about using these methods in script.

Note: If a property or method in the script editor has two forms with the same name, one form exists for legacy support and the other form is current. When possible, use the current form. To select the current form, append .X. to the name of the object to which the property or method applies, and then enter the property or method name. For instance, enter MyObject.X.MyProperty. If a property or method in the script editor has only one form, the X method might or might not apply. The X method column in the table below indicates whether or not a property or method is accessible using the X method.

Method X Method Description

AboutBox

Yes

The AboutBox method displays an About dialog box for the control.

Syntax

AboutBox()

Example

The following examples launch an About dialog box for the control.

Copy
AboutBox
Sub ShowAboutBox()
 
    <Object>.AboutBox
 
End Sub

Sub ButtonTool_EventClick()

    Dim This : Set This = ButtonTool
    <Object>.AboutBox
 
End Sub

AlarmAcknowledge

No

The AlarmAcknowledge method acknowledges an alarm.

CanNavNext

Yes

The CanNavNext method specifies whether the next target item (facility or node) can be selected.

CanNavPrev

Yes

The CanNavPrev method specifies whether the previous target item (facility or node) can be selected.

CanSelNext

Yes

The CanSelNext method returns True if the next item (facility attribute value or node) for the specified level can be selected. Otherwise returns False.

CanSelPrev

Yes

The CanSelPrev method returns True if the previous item (facility attribute value or node) for the specified level can be selected. Otherwise returns False.

ClearMenu

No

The ClearMenu method clears all custom items from the context menu.

Syntax

ClearMenu()

Parameters
  • This method takes no parameters.
Return Values
  • This method returns no values.

EnableAllRootNodeRules

Yes

The EnableAllRootNodeRules method enables or disables all rules and vectors for the root node.

EnableAllRules

Yes

The EnableAllRules method enables or disables all rules and vectors, either unilaterally, or for the specified level. Passing True for Enable enables all rules; passing False disables all rules.

EnableRootNodeRule

Yes

The EnableRootNodeRule method enables or disables a rule or vector of rules by name for the root node.

EnableRule

Yes

The EnableRule method enables or disables the specified rule or set of rules for the specified level. True enables the rule or vector; False disables it.

FacilityConfig

No

 

GetAllNodesAttrValues

Yes

The GetAllNodesAttrValues method returns the attribute values of all nodes for the specified level. The AttributeId parameter can be a string or a number.

GetDlgCtrlID

No

The GetDlgCtrlID method returns the numeric resource identifier of the control within TheView.

GetGroup

No

The GetGroup method returns the object group to which an object belongs, and returns null if the object does not belong to a group. The GroupID property returns the GroupID. Calling GetGroup is equivalent to calling TheView GetGroupByID and passing the value of the object’s GroupID property, and is provided for convenience.

GetGrpNavBarCustomAttribute

Yes

The GetGrpNavBarCustomAttribute method retrieves the value of a custom attribute.

GetRootNodeRuleNames

Yes

The GetRootNodeRuleNames method retrieves the names of enabled and disabled rules for the root node.

GetRuleNames

Yes

The GetRuleNames method returns the names of all rules or sets of rules that have a configured name for the specified level. Separate arrays are returned for rules that are enabled and for rules that are disabled.

GetSelectedNodeAttrValue

Yes

The GetSelectedNodeAttrValue method returns the attribute value of the selected node for the specified level. The AttributeId parameter can be a string or a number.

HistoryAlarms

No

The HistoryAlarms method calls the Alarm History dialog box, which shows the alarm history of an individual alarm, and provides options for showing only particular types of alarm events. See Alarm History for more information.

HistoryValues

No

The HistoryValues method calls the History Values dialog box, which shows all the history records for a given point, including additional information if the history name came from the PNT. See History Records for more information.

IsSelected

No

The IsSelected method indicates if the tool or control is selected. Can be used with [ContextMenuAutoSelect].

LayerName

No

The LayerName method gets the name of the layer on which the object resides.

Move

No

The Move method moves an object by the specified amount, relative to its current position.

NavNext

Yes

The NavNext method navigates to the next target facility or node. Returns the number of the lowest-level combo box whose selection changed. The EventOnSelChangeLevel event is triggered when NavNext is called.

NavPrev

Yes

The NavPrev method navigates to the previous target facility or node. Returns the number of the lowest-level combo box whose selection changed. The EventOnSelChangeLevel event is triggered when NavPrev is called.

NotifySelChange

No

The NotifySelChange method forces a complete refresh of the tool and any connected/affected objects. For example, when used with a Group Navigation Bar, NotifySelChange forces a filter change on a Group Navigation Bar to apply to an associated Group Grid object.

OnUpdate

No

The OnUpdate method updates the control to ensure that any property modifications have taken effect.

OnUpdateResize

No

The OnUpdateResize method updates the control to ensure that any modifications to its boundary have taken effect.

OnUpdateStyle

No

The OnUpdateStyle method updates the control to ensure that any modifications to its style properties have taken effect.

PointConfigAlarmSettings

No

 

PointConfigAlarmSuppression

No

 

PointConfigAll

No

 

PointConfigComments

No

 

PointConfigQuestionable

No

 

RegisterPointForChangeNotice

No

The RegisterPointForChangeNotice method registers an unrelated point on a screen that may change its value. Used in conjunction with EventPointChange.

RemoveMenuItem

No

 

RunInitialize

No

The RunInitialize method runs the object’s EventInitialize event code.

RunPumpData

No

This method is not used.

Select

No

The Select method selects the tool or control. "True" to select, "false" to clear. Can be used with [ContextMenuAutoSelect].

SelFirst

Yes

The SelFirst method selects the first node at the specified level.

SelLast

Yes

The SelLast method selects the last node at the specified level.

SelNext

Yes

The SelNext method selects the next item (facility attribute value or node) for the specified level. If Wrap is True, the selection wraps to the first item, if necessary. The EventOnSelChangeLevel event is triggered when SelNext is called.

SelNode

Yes

The SelNode method selects the first node at the specified level that matches the criteria.

SelPrev

Yes

The SelPrev method selects the previous item (facility attribute value or node) for the specified level. If Wrap is True, the selection wraps to the last item, if necessary. The EventOnSelChangeLevel event is triggered when SelPrev is called.

SetFocus

No

The SetFocus method sets the focus to the control.

SetGrpNavBarCustomAttribute

 

Yes

The SetGrpNavBarCustomAttribute method sets the value of a custom attribute.

SetMenuItem

No  

SetSubMenuItem

No

 

SetTargetNode

Yes

The SetTargetNode method sets the target node that matches the criteria.

ShowConfiguration

No

 

ShowCurrentValue

No

 

TrendAddPoint

No

 

TrendRemovePoint

No

 

TrendSinglePoint

No

 

TrendSinglePointRollup

No

 

X

No

The X method returns an object that lists properties and methods specific to an ActiveX control. This method is only available for some ActiveX controls.

Back to top